<!DOCTYPE html><html><head><title>QSunSync 七牛云文件同步工具使用手册</title><meta charset='utf-8'><link href='https://dn-maxiang.qbox.me/res-min/themes/marxico.css' rel='stylesheet'><style>
.note-content  {font-family: 'Helvetica Neue', Arial, 'Hiragino Sans GB', STHeiti, 'Microsoft YaHei', 'WenQuanYi Micro Hei', SimSun, Song, sans-serif;}

</style></head><body><div id='preview-contents' class='note-content'>
                        
                    



<h1 id="qsunsync-七牛云文件同步工具使用手册">QSunSync 七牛云文件同步工具使用手册</h1>

<div><div class="toc"><div class="toc">
<ul>
<li><a href="#1初始界面">1.初始界面</a><ul>
<li><a href="#11-最近同步任务">1.1 最近同步任务</a></li>
<li><a href="#12-快速开始">1.2 快速开始</a><ul>
<li><a href="#121-新建同步任务">1.2.1 新建同步任务</a></li>
<li><a href="#122-账号设置">1.2.2 账号设置</a></li>
<li><a href="#123-关于">1.2.3 关于</a></li>
</ul>
</li>
<li><a href="#13-关闭程序">1.3 关闭程序</a></li>
</ul>
</li>
<li><a href="#2-账号设置">2. 账号设置</a><ul>
<li><a href="#21-账号设置界面">2.1 账号设置界面</a></li>
<li><a href="#22-账号设置">2.2 账号设置</a></li>
</ul>
</li>
<li><a href="#3-同步设置界面">3. 同步设置界面</a><ul>
<li><a href="#31基本设置">3.1基本设置</a><ul>
<li><a href="#311-本地目录">3.1.1 本地目录</a></li>
<li><a href="#312-目标空间">3.1.2 目标空间</a></li>
</ul>
</li>
<li><a href="#32-高级设置">3.2 高级设置</a><ul>
<li><a href="#321-附加文件前缀">3.2.1 附加文件前缀</a></li>
<li><a href="#322-忽略文件名相对路径">3.2.2 忽略文件名相对路径</a></li>
<li><a href="#323-同名文件覆盖">3.2.3 同名文件覆盖</a></li>
<li><a href="#324-分片上传阈值">3.2.4 分片上传阈值</a></li>
<li><a href="#325-同步的并发数">3.2.5 同步的并发数</a></li>
<li><a href="#326-上传目的机房">3.2.6 上传目的机房</a></li>
</ul>
</li>
<li><a href="#33-开始同步">3.3 开始同步</a></li>
</ul>
</li>
<li><a href="#4-同步信息">4. 同步信息</a><ul>
<li><a href="#41-同步进行时">4.1 同步进行时</a><ul>
<li><a href="#411-多线程同步进度表">4.1.1 多线程同步进度表</a></li>
<li><a href="#412-同步信息汇总">4.1.2 同步信息汇总</a></li>
<li><a href="#413-暂停">4.1.3 暂停</a></li>
<li><a href="#414-结束">4.1.4 结束</a></li>
</ul>
</li>
<li><a href="#42-同步完成后">4.2 同步完成后</a><ul>
<li><a href="#421-同步信息总览">4.2.1 同步信息总览</a></li>
<li><a href="#422-导出日志">4.2.2 导出日志</a></li>
<li><a href="#423-返回首页">4.2.3 返回首页</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="#5-历史记录">5. 历史记录</a></li>
</ul>
</li>
</ul>
</div>
</div>
</div>



<h3 id="1初始界面">1.初始界面</h3>

<p>打开同步工具之后，出现“初始界面”（界面 1）。</p>



<p><img src="imgs/1-01.png" alt="1-01" title=""></p>

<p><code>界面1 初始界面</code></p>

<p>初始状态下，由于尚未设置账号，因此“新建同步任务”处于不可用状态，关于“账号设置”请参考后续介绍。</p>



<h4 id="11-最近同步任务">1.1 最近同步任务</h4>

<p>保留最近同步的项目（参考后文介绍）。显示项目的同步时间、目标空间及本地同步目录。通过双击某条项目纪录，可以直接跳转至同步设置界面（界面 3），且所有配置与之前同步该项目时配置保持一致。若两次将同一个目录上传到同一个空间，只会保留最近的一条记录。</p>



<h4 id="12-快速开始">1.2 快速开始</h4>



<h5 id="121-新建同步任务">1.2.1 新建同步任务</h5>

<p>点击此处将跳转至“同步设置界面”（界面 3）新建同步任务。若之前从未在“账号 设置界面”中配置过 AK／SK 信息，该选项将为灰色，点击不会跳转。</p>



<h5 id="122-账号设置">1.2.2 账号设置</h5>

<p>点击此处将跳转至“账号设置界面”（界面 2），输入 AK/SK 登陆 QSunSync。一旦登录成功将记录 AK/SK，之后再次使用时，不需重新配置。</p>



<h5 id="123-关于">1.2.3 关于</h5>

<p>点击此处跳转到网页介绍。</p>



<h4 id="13-关闭程序">1.3 关闭程序</h4>

<p>点击界面上的“关闭”按钮，程序会隐藏至托盘，但不终止运行。如需彻底关闭，右键点击托盘图标，点击“退出”即可。</p>



<p><img src="imgs/1-02.png" alt="1-02" title=""></p>



<h3 id="2-账号设置">2. 账号设置</h3>



<h4 id="21-账号设置界面">2.1 账号设置界面</h4>

<p>初次使用 QSunSync 时需要在此页面输入 AK/SK 进行登陆。一旦登陆成功将记录 AK/SK， 之后再次使用时，无需重新配置。</p>



<p><img src="imgs/2-01.png" alt="2-01" title=""></p>

<p><code>界面2  账号设置界面</code></p>

<h4 id="22-账号设置">2.2 账号设置</h4>

<p>点击账号设置界面“查看我的AK &amp; SK”或者直接输入网址portal.qiniu.com进入portal页面。</p>



<p><img src="imgs/2-02.png" alt="2-02" title=""></p>

<p>在“秘钥管理”界面可以找到AK和SK，其中SK默认隐藏，可以点击显示框中的“显示”按钮展现明文。</p>



<p><img src="imgs/2-03.png" alt="2-03" title=""></p>

<p>将对应的AK和SK填入账号设置的对应输入框中，点击“保存”即可。</p>



<h3 id="3-同步设置界面">3. 同步设置界面</h3>

<p>设置好账户AK&amp;SK之后，主界面“新建同步任务”已经变为可用状态。</p>



<p><img src="imgs/3-01.png" alt="3-01" title=""></p>

<p>点击“新建同步任务”进入任务同步设置。</p>



<p><img src="imgs/3-02.png" alt="3-02" title=""></p>

<p><code>界面3  同步设置界面</code></p>



<h4 id="31基本设置">3.1基本设置</h4>



<h5 id="311-本地目录">3.1.1 本地目录</h5>

<p>选择需要同步到七牛的本地目录。</p>



<p><img src="imgs/3-03.png" alt="3-03" title=""></p>



<h5 id="312-目标空间">3.1.2 目标空间</h5>

<p>将文件上传到七牛指定空间</p>



<p><img src="imgs/3-04.png" alt="3-04" title=""></p>



<p><img src="imgs/3-04-x.png" alt="3-04-x" title=""></p>



<h4 id="32-高级设置">3.2 高级设置</h4>



<p><img src="imgs/3-05-1.png" alt="3-05-1" title=""></p>



<p><img src="imgs/3-05-2.png" alt="3-05-2" title=""></p>



<h5 id="321-附加文件前缀">3.2.1 附加文件前缀</h5>

<p>可使用前缀进行文件管理。</p>

<p>示例：如需要将两个文件夹 a、b 同步到同一七牛空间，其 中文件夹 a 内全为图片，有文件 1.jpg、2.jpg 等；文件夹 b 中全为视频，有文件 3.mp4、 4.mp4 等。为了方便管理，在文件夹 a 同步时，设置前缀为 img，则文件 1.jpg、2.jpg 在七 牛空间中的 key（文件名）分别为：img1.jpg 及 img2.jpg。文件夹 b 同步时，设置前缀为 video，则文件 3.mp4、4.mp4 在七牛空间中的 key 为：video3.mp4 及 video4.mp4。</p>



<h5 id="322-忽略文件名相对路径">3.2.2 忽略文件名相对路径</h5>

<p>示例：假设有同步文件夹 sub1，其中 sub1 下有子文件夹 sub2，文件夹sub2下有文件夹sub3，如下图所示，其中sub3下有图片1.jpg。若勾选该选项，则此图片在七牛空间中的key为sub1/sub2/sub3/1.jpg,勾选之后的key为1.jpg。</p>



<p><img src="imgs/3-06.png" alt="3-06" title=""></p>



<h5 id="323-同名文件覆盖">3.2.3 同名文件覆盖</h5>

<p>文件上传到空间时，会通过对比 hash 确认是否空间中已有相同文件。若 hash 相等，则 不会上传新文件。若 hash 不相等，则会查看“空间中同名文件强制覆盖”选项，如该选项被勾选，则会上传新的文件，若此选项不被勾选，则会报错。</p>



<h5 id="324-分片上传阈值">3.2.4 分片上传阈值</h5>

<p>默认值为最大4MB。设置阈值后，若文件大小大于等于该值，则自动使用分片上传。小于该值则自动使用表单上传。</p>



<h5 id="325-同步的并发数">3.2.5 同步的并发数</h5>

<p>可以允许多文件同时并发上传，并发数可选范围：1～60。</p>



<h5 id="326-上传目的机房">3.2.6 上传目的机房</h5>

<p>程序会根据用户的Bucket(目标空间)自动配置，可选项包括”直传”和”CDN加速”。</p>



<p><img src="imgs/3-07.png" alt="3-07" title=""></p>



<h4 id="33-开始同步">3.3 开始同步</h4>

<p>完成以上所有设置后，点击“开始同步按钮”开始同步。</p>



<h3 id="4-同步信息">4. 同步信息</h3>

<p>点击“开始同步”按钮后，如果一切正常，程序会跳转到“同步进度”页面。</p>



<h4 id="41-同步进行时">4.1 同步进行时</h4>



<p><img src="imgs/4-01.png" alt="4-01" title=""></p>

<p><code>界面4.1  同步进度界面</code></p>



<h5 id="411-多线程同步进度表">4.1.1 多线程同步进度表</h5>

<p>可得到每个线程的同步文件名、当前文件上传进度及速度。</p>



<h5 id="412-同步信息汇总">4.1.2 同步信息汇总</h5>

<p>可得到完成同步文件个数及同步完成百分比。</p>



<h5 id="413-暂停">4.1.3 暂停</h5>

<p>暂停后该按钮变为“继续”，点击“继续”按钮可继续此次同步任务。若在暂停时有文件尚未传完，该文件可在“继续”后断点续传。</p>



<h5 id="414-结束">4.1.4 结束</h5>

<p>点击按钮跳此次同步结束，跳转至同步完成界面（界面 4.2）。此次任务及其配置将会保存至最近同步任务。若在结束时有文件尚未传完，该文件之后可断点续传。</p>



<h4 id="42-同步完成后">4.2 同步完成后</h4>



<p><img src="imgs/4-01.png" alt="4-01" title=""></p>

<p><code>界面4.2  同步完成界面</code></p>



<h5 id="421-同步信息总览">4.2.1 同步信息总览</h5>

<p>可得到同步时间及同步成功/失败等文件名及错误信息。</p>



<h5 id="422-导出日志">4.2.2 导出日志</h5>

<p>可导出本次同步日志，包含同步成功及失败文件信息。</p>



<h5 id="423-返回首页">4.2.3 返回首页</h5>

<p>跳转至初始界面（界面 1）。</p>



<h3 id="5-历史记录">5. 历史记录</h3>

<p>回到主页后，在“最近同步任务”列表中可以看到同步历史（按最近时间排列）。选择指定记录，右键菜单中有“删除任务”（删除历史记录）和“导出日志”功能。</p>



<p><img src="imgs/5-01.png" alt="5-01" title=""></p>

<p><code>界面5 主界面(历史记录)</code></p></div></body></html>